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1. Overview 

The line printer system supports: 

• multiple printers, 

• multiple spooling queues, 

• both local and remote printers, and 

• printers attached via serial lines which require line initialization such as the baud rate. 

Raster output devices such as a Varian or Versatec, and laser printers such as an Imagen, are 
also supported by the line printer system. 

The line printer system consists mainly of the following files and commands: 

/etc/printcap printer configuration and capability data base 

/usr/lib/lpd line printer daemon, does all the real work 

/usr/ucb/lpr program to enter a job in a printer queue 

/usr/ucb/lpq spooling queue examination program 

/usr/ucb/lprm program to delete jobs from a queue 

/etc/lpc program to administer printers and spooling queues 

/dev/printer socket on which lpd listens 

The file /etc/printcap is a master data base describing line printers directly attached to a 
machine and, also, printers accessible across a network. The manual page entry printcap(5) 
provides the ultimate definition of the format of this data base, as well as indicating default 
values for important items such as the directory in which spooling is performed. This 
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document highlights the important information which may be placed printcap. 



2. Commands 

2.1. lpd — line printer dameon 

The program lpd(8), usually invoked at boot time from the /etc/rc file, acts as a master 
server for coordinating and controlling the spooling queues configured in the printcap file. 
When lpd is started it makes a single pass through the printcap database restarting any 
printers which have jobs. In normal operation lpd listens for service requests on multiple 
sockets, one in the UNIX domain (named "/dev/printer") for local requests, and one in the 
Internet domain (under the "printer" service specification) for requests for printer access from 
off machine; see socket (2) and services (5) for more information on sockets and service 
specifications, respectively. Lpd spawns a copy of itself to process the request; the master 
daemon continues to listen for new requests. 

Clients communicate with lpd using a simple transaction oriented protocol. Authentica- 
tion of remote clients is done based on the "privilege port" scheme employed by rshd (8C) and 
rcmd(3X). The following table shows the requests understood by lpd. In each request the 
first byte indicates the "meaning" of the request, followed by the name of the printer to which 
it should be applied. Additional qualifiers may follow, depending on the request. 

Request Interpretation 

"Aprinter \n check the queue for jobs and print any found 

"Bprinter \n receive and queue a job from another machine 

"Cprinter [users ...] [jobs ...]\n return short list of current queue state 

A Dprinter [users ...] [jobs ...]\n return long list of current queue state 

"Eprinter person [users ...] [jobs ...]\n remove jobs from a queue 

The lpr(l) command is used by users to enter a print job in a local queue and to notify 
the local lpd that there are new jobs in the spooling area. Lpd either schedules the job to be 
printed locally, or in the case of remote printing, attempts to forward the job to the appropri- 
ate machine. If the printer cannot be opened or the destination machine is unreachable, the 
job will remain queued until it is possible to complete the work. 

2.2. lpq — show line printer queue 

The lpq (1) program works recursively backwards displaying the queue of the machine 
with the printer and then the queue(s) of the machine(s) that lead to it. Lpq has two forms 
of output: in the default, short, format it gives a single line of output per queued job; in the 
long format it shows the list of files, and their sizes, which comprise a job. 

2.3. lprm - remove jobs from a queue 

The lprm(l) command deletes jobs from a spooling queue. If necessary, lprm will first 
kill off a running daemon which is servicing the queue, restarting it after the required files are 
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it first checks locally for jobs to remove and then tries to remove files in queues off-machine. 
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2.4. lpc — line printer control program 

The /pc(8) program is used by the system administrator to control the operation of the 
line printer system. For each line printer configured in /etc/printcap, lpc may be used to: 

• disable or enable a printer, 

• disable or enable a printer's spooling queue, 

• rearrange the order of jobs in a spooling queue, 

• find the status of printers, and their associated spooling queues and printer dameons. 

3. Access control 

The printer system maintains protected spooling areas so that users cannot circumvent 
printer accounting or remove files other than their own. The strategy used to maintain pro- 
tected spooling areas is as follows: 

• The spooling area is writable only by a daemon user and spooling group. 

• The Ipr program runs setuid root and setgid spooling. The root access is used to read any 
file required, verifying accessibility with an access (2) call. The group ID is used in setting 
up proper ownership of files in the spooling area for Iprm. 

• Control files in a spooling area are made with daemon ownership and group ownership 
spooling. Their mode is 0660. This insures control files are not modified by a user and 
that no user can remove files except through Iprm. 

• The spooling programs, Ipd, Ipq, and Iprm run setuid root and setgid spooling to access 
spool files and printers. 

• The printer server, Ipd, uses the same verification procedures as rshd (8C) in authenticat- 
ing remote clients. The host on which a client resides must be present in the file 
/etc/hosts.equiv, used to create clusters of machines under a single administration. 

In practice, none of Ipd, Ipq, or Iprm would have to run as user root if remote spooling 
were not supported. In previous incarnations of the printer system Ipd ran setuid daemon, 
setgid spooling, and Ipq and Iprm ran setgid spooling. 

4. Setting up 

The 4.2BSD release comes with the necessary programs installed and with the default 
line printer queue created. If the system must be modified, the makefile in the directory 
/usr/src/usr.lib/lpr should be used in recompiling and reinstalling the necessary programs. 

The real work in setting up is to create the printcap file and any printer filters for 
printers not supported in the distribution system. 

4.1. Creating a printcap file 

The printcap database contains one or more entries per printer. A printer should have 
a separate spooling directory; otherwise, jobs will be printed on different printers depending 
on which printer daemon starts first. This section describes how to create entries for printers 
which do not conform to the default printer description (an LP- 11 style interface to a stan- 
dard, band printer). 
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4.1.1. Printers on serial lines 

When a printer is connected via a serial communication line it must have the proper 
baud rate and terminal modes set. The following example is for a DecWriter III printer con- 
nected locally via a 1200 baud serial line. 

lplLA-180 DecWriter III:\ 

:lp=/dev/lp:br#1200:fs#06320:\ 
:tr= \ f :of=/usr/lib/lpf :lf=/usr/adm/lpd-errs: 

The lp entry specifies the file name to open for output. In this case it could be left out since 
"/dev/lp" is the default. The br entry sets the baud rate for the tty line and the fs entry sets 
CRMOD, no parity, and XTABS (see tty (4)). The tr entry indicates a form-feed should be 
printed when the queue empties so the paper can be torn off without turning the printer off- 
line and pressing form feed. The of entry specifies the filter program Ipf should be used for 
printing the files; more will be said about filters later. The last entry causes errors to be writ- 
ten to the file "/usr/adm/lpd-errs" instead of the console. 

4.1.2. Remote printers 

Printers which reside on remote hosts should have an empty lp entry. For example, the 
following printcap entry would send output to the printer named "lp" on the machine 
"ucbvax". 

lpldefault line printer:\ 

:lp = :rm = ucbvax:rp = lp:sd = /usr/spool/vaxlpd: 

The rm entry is the name of the remote machine to connect to; this name must appear in the 
/etc/hosts database, see hosts (5). The rp capability indicates the name of the printer on the 
remote machine is "lp"; in this case it could be left out since this is the default value. The sd 
entry specifies "/usr/spool/vaxlpd" as the spooling directory instead of the default value of 
"Aisr/spool/lpd". 

4.2. Output filters 

Filters are used to handle device dependencies and to perform accounting functions. 
The output filter of is used to filter text data to the printer device when accounting is not 
used or when all text data must be passed through a filter. It is not intended to perform 
accounting since it is started only once, all text files are filtered through it, and no provision is 
made for passing owners' login name, identifying the begining and ending of jobs, etc. The 
other filters (if specified) are started for each file printed and perform accounting if there is an 
af entry. If entries for both of and one of the other filters are specified, the output filter is 
used only to print the banner page; it is then stopped to allow other filters access to the 
printer. An example of a printer which requires output filters is the Benson- Varian. 

val varian I Benson- Varian: \ 

:lp=/dev/vaO:sd = /usr/ spool/vad:of = / usr/lib/vpf: \ 
:tf=/usr/lib/rvcat:mx#2000:pl#58:tr=\f: 

The tf entry specifies "/usr/lib/rvcat" as the filter to be used in printing troff(l) output. This 
filter is needed to set the device into print mode for text, and plot mode for printing troff files 
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and raster images (see va(4V)). Note that the page length is set to 58 lines by the pi entry 
for 8.5" by 11" fan-fold paper. To enable accounting, the varian entry would be augmented 
with an af filter as shown below. 

va I varian I Benson- Varian: \ 

:lp = / de v/ vaO:sd = / usr/ spool/ vadrof = /usr/lib/vpf :\ 

: if = / usr/lib/ vpf :tf = /usr/lib/ r vcat:af = / usr/ adm/vaacct:\ 

:mx#2000:pl#58:tr=\f: 

5. Output filter specifications 

The niters supplied with 4.2BSD handle printing and accounting for most common line 
printers, the Benson-Varian, the wide (36") and narrow (11") Versatec printer/plotters. For 
other devices or accounting methods, it may be necessary to create a new filter. 

Filters are spawned by Ipd with their standard input the data to be printed, and stan- 
dard output the printer. The standard error is attached to the If file for logging errors. A 
filter must return a 0 exit code if there were no errors, 1 if the job should be reprinted, and 2 
if the job should be thrown away. When Iprm sends a kill signal to the Ipd process controlling 
printing, it sends a SIGINT signal to all filters and descendents of filters. This signal can be 
trapped by filters which need to perform cleanup operations such as deleting temporary files. 

Arguments passed to a filter depend on its type. The of filter is called with the follow- 
ing arguments. 

ofiler — wwidth — llength 

The width and length values come from the pw and pi entries in the printcap database. The 
if filter is passed the following parameters. 

filter [— c] —wwidth —llength — iindent — n login — h host accounting file 

The — c flag is optional, and only supplied when control characters are to be passed uninter- 
preted to the printer (when the —1 option of Ipr is used to print the file). The — w and — 1 
parameters are the same as for the of filter. The — n and — h parameters specify the login 
name and host name of the job owner. The last argument is the name of the accounting file 
from printcap. 

All other filters are called with the following arguments: 

filter — xwidth — ylength — n login — h host accounting file 

The —x and — y options specify the horizontal and vertical page size in pixels (from the px 
and py entries in the printcap file). The rest of the arguments are the same as for the if 
filter. 

6. Line printer Administration 

The Ipc program provides local control over line printer activity. The major commands 
and their intended use will be described. The command format and remaining commands are 
described in /pc(8). 
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abort and start 

Abort terminates an active spooling daemon on the local host immediately and then dis- 
ables printing (preventing new daemons from being started by Ipr). This is normally 
used to forciblly restart a hung line printer daemon (i.e., Ipq reports that there is a dae- 
mon present but nothing is happening). It does not remove any jobs from the queue 
(use the Iprm command instead). Start enables printing and requests Ipd to start print- 
ing jobs. 

enable and disable 

Enable and disable allow spooling in the local queue to be turned on/off. This will 
allow/prevent Ipr from putting new jobs in the spool queue. It is frequently convenient 
to turn spooling off while testing new line printer filters since the root user can still use 
Ipr to put jobs in the queue but no one else can. The other main use is to prevent users 
from putting jobs in the queue when the printer is expected to be unavailable for a long 
time. 

restart 

Restart allows ordinary users to restart printer daemons when Ipq reports that there is 
no daemon present. 

stop 

Stop is used to halt a spooling daemon after the current job completes; this also disables 
printing. This is a clean way to shutdown a printer in order to perform maintenence, 
etc. Note that users can still enter jobs in a spool queue while a printer is stopped. 

topq 

Topq places jobs at the top of a printer queue. This can be used to reorder high priority 
jobs since Ipr only only provides first-come-flrst-serve ordering of jobs. 

7. Troubleshooting 

There are a number of messages which may be generated by the the line printer system. 
This section categorizes the most common and explains the cause for their generation. Where 
the message indicates a failure, directions are given to remedy the problem. 

In the examples below, the name printer is the name of the printer. This would be one 
of the names from the printcap database. 

7.1. LPR 

Ipr: printer: unknown printer 

The printer was not found in the printcap database. Usually this is a typing mistake; 
however, it may indicate a missing or incorrect entry in the /etc/printcap file. 

Ipr: printer: jobs queued, but cannot start daemon. 

The connection to Ipd on the local machine failed. This usually means the printer server 
started at boot time has died or is hung. Check the local socket /dev/printer to be sure 
it still exists (if it does not exist, there is no Ipd process running). Use 



Line Printer Spooler Manual 7 



% ps ax I fgrep lpd 

to get a list of process identifiers of running lpd's. The lpd to kill is the one which is not 
listed in any of the "lock" files (the lock file is contained in the spool directory of each 
printer). Kill the master daemon using the following command. 

% kill pid 

Then remove /dev/printer and restart the daemon (and printer) with the following com- 
mands. 

% rm /dev/printer 
% /usr/lib/lpd 

Another possibility is that the Ipr program is not setuid root, setgid spooling. This can 
be checked with 

% Is — lg /usr/ucb/lpr 



lpr: printer: printer queue is disabled 

This means the queue was turned off with 
% lpc disable printer 

to prevent lpr from putting files in the queue. This is normally done by the system 
manager when a printer is going to be down for a long time. The printer can be turned 
back on by a super-user with lpc. 



7.2. LPQ 



waiting for printer to become ready (offline ?) 

The printer device could not be opened by the daemon. This can happen for a number 
of reasons, the most common being that the printer is turned off-line. This message can 
also be generated if the printer is out of paper, the paper is jammed, etc. The actual 
reason is dependent on the meaning of error codes returned by system device driver. Not 
all printers supply sufficient information to distinguish when a printer is off-line or hav- 
ing trouble (e.g. a printer connected through a serial line). Another possible cause of this 
message is some other process, such as an output filter, has an exclusive open on the 
device. Your only recourse here is to kill off the offending program(s) and restart the 
printer with lpc. 

printer is ready and printing 

The Ipq program checks to see if a daemon process exists for printer and prints the file 
status. If the daemon is hung, a super user can use lpc to abort the current daemon and 
start a new one. 
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waiting for host to come up 

This indicates there is a daemon trying to connect to the remote machine named host in 
order to send the files in the local queue. If the remote machine is up, Ipd on the remote 
machine is probably dead or hung and should be restarted as mentioned for Ipr. 

sending to host 

The files should be in the process of being transferred to the remote host. If not, the 
local daemon should be aborted and started with Ipc. 

Warning: printer is down 

The printer has been marked as being unavailable with Ipc. 

Warning: no daemon present 

The Ipd process overseeing the spooling queue, as indicated in the "lock" file in that 
directory, does not exist. This normally occurs only when the daemon has unexpectedly 
died. The error log file for the printer should be checked for a diagnostic from the 
deceased process. To restart an Ipd, use 

% Ipc restart printer 

7.3. LPRM 

lprm: printer: cannot restart printer daemon 

This case is the same as when Ipr prints that the daemon cannot be started. 

7.4. LPD 

The Ipd program can write many different messages to the error log file (the file 
specified in the If entry in print cap). Most of these messages are about files which can not be 
opened and usually indicate the printcap file or the protection modes of the files are not 
correct. Files may also be inaccessible if people manually manipulate the line printer system 
(i.e. they bypass the Ipr program). 

In addition to messages generated by Ipd, any of the filters that Ipd spawns may also log 
messages to this file. 

7.5. LPC 

could't start printer 

This case is the same as when Ipr reports that the daemon cannot be started. 

cannot examine spool directory 

Error messages beginning with "cannot ..." are usually due to incorrect ownership and/or 
protection mode of the lock file, spooling directory or the Ipc program. 
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